Power Utilities

home *** CD-ROM | disk | FTP | other *** search

/ Power Utilities / Power Utilities.iso / ek / tm122 / tm.doc < prev next >

Wrap

Text File | 1990-05-19 | 44.7 KB | 1,046 lines

TreeMaster 1.22 Copyright 1990 by New-Ware All Rights Reserved (tm) ┌─────────┐ ┌─────┴───┐ │ MEMBER ───│ │ │──────────────── │ ┌──────┴──┐ │ Association of │ │ ├──┘ Shareware └──┤ ■ │ Professionals ──────│ ║ │─────────────────── └────╨────┘ Contents INTRODUCTION . . . . . . . . . . . . . . . . . . . . 2 PRODUCT REGISTRATION . . . . . . . . . . . . . . . . 3 VERSION HISTORY . . . . . . . . . . . . . . . . . . . 4 GENERAL PROGRAM DESCRIPTION . . . . . . . . . . . . . 5 PROGRAM OPERATION . . . . . . . . . . . . . . . . . . 6 STARTING TM . . . . . . . . . . . . . . . . . . . 6 MAIN TM DISPLAY . . . . . . . . . . . . . . . . . 6 THE CURSOR BAR . . . . . . . . . . . . . . . . . . 7 MOUSE SUPPORT . . . . . . . . . . . . . . . . . . 7 FUNCTION KEY COMMANDS . . . . . . . . . . . . . . 7 F-1 KEY . . . . . . . . . . . . . . . . . . . . . 8 F-2 KEY . . . . . . . . . . . . . . . . . . . . . 8 F-3 KEY . . . . . . . . . . . . . . . . . . . . . 8 F-4 KEY . . . . . . . . . . . . . . . . . . . . . 8 F-5 KEY . . . . . . . . . . . . . . . . . . . . . 9 F-6 KEY . . . . . . . . . . . . . . . . . . . . . 9 F-7 KEY . . . . . . . . . . . . . . . . . . . . . 9 F-8 KEY . . . . . . . . . . . . . . . . . . . . . 10 F-9 KEY . . . . . . . . . . . . . . . . . . . . . 10 F-10 KEY . . . . . . . . . . . . . . . . . . . . . 10 OTHER TM COMMANDS . . . . . . . . . . . . . . . . 10 INS KEY . . . . . . . . . . . . . . . . . . . . . 10 DEL KEY . . . . . . . . . . . . . . . . . . . . . 11 CTRL-END KEY . . . . . . . . . . . . . . . . . . . 11 CTRL-HOME KEY . . . . . . . . . . . . . . . . . . 11 TAB KEY . . . . . . . . . . . . . . . . . . . . . 12 CTRL-M KEY . . . . . . . . . . . . . . . . . . . . 12 CTRL-P KEY . . . . . . . . . . . . . . . . . . . . 12 CTRL-R KEY . . . . . . . . . . . . . . . . . . . . 12 CTRL-S KEY . . . . . . . . . . . . . . . . . . . . 12 FILE BROWSE MODE . . . . . . . . . . . . . . . . . . 13 DIRECTORY NAME SEARCH . . . . . . . . . . . . . . . . 13 PROGRAM LIMITATIONS . . . . . . . . . . . . . . . . . 14 ERROR HANDLING . . . . . . . . . . . . . . . . . . . 14 CREDITS . . . . . . . . . . . . . . . . . . . . . . . 15 Index 17 i INTRODUCTION The program author, John J. Newlin, is an active member of the Association of Shareware Professionals (ASP). The ASP wants to make sure that the Shareware principle works for you. If you are unable to resolve a Shareware related problem with an ASP member by contacting the member directly, ASP may be able to help. The ASP Ombudsman can help you resolve a dispute or problem with an ASP member, but does not provide technical support for members' products. Please write to the ASP Ombudsman at P.O. Box 5786, Bellevue, WA 98006 or send a Compuserve message via EASYPLEX to ASP Ombudsman 70007,3536. DISCLAIMER New-Ware hereby disclaims all warranties relating to this product, whether express or implied, including without limitation any implied warranties of merchantability or fitness for a particular purpose. New- Ware cannot and will not be liable for any special, incidental, consequential, indirect or similar damages due to loss of data or any other reason, even if New-Ware or an authorized New-Ware agent has been advised of the possibility of such damages. In no event shall the liability for any damages ever exceed the price paid for the license to use software, regardless of the form and/or extent of the claim. The user of this program bears all risk as to the quality and performance of the software. PRODUCT LICENSE TreeMaster is a Shareware product. As such, it is made available to the general computing public for evaluation. Users are licensed to operate TreeMaster on their personal computers for the purpose of test and evaluation on a trial basis for a limited trial period. It is not possible to reasonably define any definitive limits of a fair and equitable time period for evaluation, therefore it is left to the user's judgment and sense of fair play as to the time required to make a decision as to its usefulness. If the user decides the program is not of sufficient merit to warrant purchase through registration with New- Ware, the program should be removed from their personal computer. Otherwise, if the program is deemed useful and is in regular use on the user's personal computer system, registration with New-Ware is required. Registered users are those users that elect to pay for TreeMaster and register that payment with New-Ware. By virtue of registration and payment for the program, registered users are granted a license to continue to utilize the program on their personal computer for as long as they choose. This license authorizes the user to use the program on any personal computer system he or she may own so long as the program is operated on only one computer system at a time. - 2 - PRODUCT REGISTRATION TreeMaster is sole property of New-Ware Shareware Products. The Shareware version, and ONLY that version, may be freely copied and transferred to individual parties for evaluation purposes. The Shareware version, and ONLY that version, may be posted on Bulletin Board systems (BBS) for electronic access as long as NO FEE is charged for its distribution except for private BBS operations that charge a regular user subscription fee. Computer information services such as Compuserve (CIS) and Genie, etc., are authorized to post this product for subscriber access. The Shareware version of TreeMaster may NOT be distributed on diskette by any disk distributor/vendor that charges more than $12.00 for the diskette upon which the program and attendant files are recorded without written consent from New-Ware. TreeMaster is a fully functional Shareware product. Shareware is a computer program distribution/marketing method that permits potential buyers to thoroughly try the program prior to purchase. It is NOT free and it is not in the Public Domain. If, after evaluating the program, you find it to be useful enough to use it on a regular basis, you are expected to pay for it by registering with New-Ware. The registration fee is $25.00 and the registered version, which is NOT distributed as Shareware, will not contain the opening Shareware screen nor the closing messages. You may register TreeMaster in one of three ways: 1) By mail with check or money order to: New-Ware 8050 Camino Kiosco San Diego, CA 92122-1820 2) By telephone with Visa/Mastercard to: New-Ware (619) 455-6225 3) Electronically through the New-Ware BBS: New-Ware Shareware Products BBS Running Wildcat! version 2.10p (619) 450-3257 - Node #1 1200/2400/9600 (HST) 455-5226 - Node #2 1200/2400 The New-Ware Shareware Products BBS operates 24 hours per day, 7 days per week. Node #1 is dedicated to registered users only. Nodes #2 is open to all callers. Users registering via the BBS receive access to the latest registered version within 1 day after leaving their credit - 3 - card data. Users who register by mail or phone may also access the registered version by BBS, but you MUST log on and leave a comment to the sysop to the effect that you are a registered user and desire access. The author can also on CIS via PPN 71535,665 (please use EASYPLEX). This Shareware version of TreeMaster may be freely copied and passed on to other individual users for their evaluation. Disk vendors and/or distributors that desire to distribute TreeMaster must adhere to the guidelines presented in the file VENDOR.DOC. Press Alt-R from the opening Shareware screen or the main TreeMaster display to activate the registration window. Prompts will be issued for the pertinent information and you will have the option of printing the registration form when the form is completed. The Shareware version is completely functional. The only differences between it and the version a registered user receives is the opening Shareware screen and the ability to print the registration form. CALIFORNIA RESIDENTS MUST INCLUDE 7.25% STATE SALES TAX! I support my software. One of the great strengths of the Shareware concept is the interaction between the program author and the users. Many of the features contained in TreeMaster are the result of user input. If you have a problem evaluating this program or desire to make a suggestion or comment (or even a complaint), please do not hesitate to contact me. Even if you register TreeMaster, if you later determine that it is unsuitable for your use, you may contact me for a refund. It is not necessary that you be a registered user to contact me for technical support. Technical support will be available through the U.S mail, telephone, or the New-Ware BBS. VERSION HISTORY 1.00 - Released 05-05-90 1.10 - Released 05-08-90 - Minor bug fixes. - Removed beeps during file search. - Added directory memo editor. - Added context sensitive on-line help. - Added capability to LIST non-executable files. 1.20 - Released 05-11-90 - Complete revision of file browsing. Added full browsing of sorted file list found through the search function or in a specific directory. - Added mouse support. - Added capability to call ArcMaster. - Added capability to edit a file with QEDIT. - 4 - 1.21 - Released 05-15-90 - Improved the speed of the nested (filename/ext) sort by a factor of 10. - Added Kim Kokkonen's (TurboPower Software) EMS/Disk swapping unit for use in calling external programs. - Added support for calls to the following programs: > PKZIP/PKUNZIP from PKWare > VirusSCAN from McAfee > LZESHELL from Pete Petrakis 1.22 - Released 05-20-90 - Added directory listing of ARC and ZIP files. - Added LISTing compressed files inside ARC or ZIP files. - Added removal of a complete subtree structure. - Added capability to automatically adjust to monitors in extended line (above 25 lines) mode. GENERAL PROGRAM DESCRIPTION TreeMaster, hereinafter referred to as TM, is a powerful, full- featured hard disk directory manager. With the advent of DOS 2.0, a hierarchical directory tree structure was implemented to facilitate the organization of files. Unfortunately, this tree structure can be very clumsy to utilize from the DOS prompt level with such commands as CHDIR and DIR. In fact, there is no intrinsic DOS command that displays the current directory tree structure. Trying to remember the tree, especially if it is large, can be a real pain and an even worse pain is all the typing required to access directories that are more than one level deep on the tree. TM is designed to make navigation of a hard disk and its attendant directory tree structure a snap. TM displays the directory structure as a graphic tree, twenty directories per page and all the directories are alphabetically sorted within tree levels of depth. Through the use of a movable cursor bar and function key commands, the user may accomplish a great deal of directory management functions quickly and easily. For example, directories may be added, deleted, purged, or renamed with just a few keystrokes. And the auxiliary disk information and file windows keep the user fully informed as to the current status of the directory organization. There's much, much more to TM. It is very intuitive and quite easy to use, but it is recommended that the remainder of this document be perused before running this excellent utility. - 5 - PROGRAM OPERATION STARTING TM Starting and running TM is simple. It accepts only one command line parameter. If started with no parameter, TM will operate on the currently active drive. If the user desires to operate on another drive, simply add the drive letter (upper or lower case, no colon) as a command parameter. For example: TM d In this example, TM will load and begin operation on drive D. As distributed, TM is configured to automatically detect and utilize either monochrome or color monitors. Some monitors, however, report themselves as color monitors but do not fully support the standard color attributes. Laptop computers are typical of this group. If the display problematic for this reason, press Ctrl-T to activate the TM configuration window, press the "C" key to toggle TM to the "Force mono mode", and then save the configuration to disk. The next time TM is run, it will go into a monochrome mode, which is much more readable on a laptop monitor. TM will recognize and adjust to special monitor modes that display greater than 25 lines per screen such as the EGA/VGA 43/50 line mode. TM may be operated from any drive:\directory in a system providing that the directory in which it resides is identified in the DOS PATH statement. Please see the file PATHINFO.TXT for an explanation of how to utilize the DOS PATH capability. To exit from TM and remain in the directory from which it was loaded, press the Esc key or press Alt-X. Pressing the Esc key to exit affords the user the opportunity to confirm the intention to quit the program. MAIN TM DISPLAY The main display of TM is designed to provide the maximum amount of information without cluttering up the screen. The graphic tree is contained in a window which occupies the full left side of the screen. The upper right hand corner of the screen is occupied by a window that shows information pertinent to the currently active drive. A window in the lower right hand of the screen will display up to ten files from the directory that is currently highlighted by the cursor bar. Each time the cursor is moved, the file list window is updated. This window also has a functional use in support of executing programs, which will be described later. - 6 - THE CURSOR BAR Operation of TM is primarily based upon use of the cursor bar in a "point-and-shoot" manner. The Up/Down arrows, PgUp/PgDn, and Home/End keys are used to move the cursor. Pressing the Home key positions the cursor at the first directory on the tree. The End key moves the cursor to the last directory on the tree. PgUp and PgDn can be used to page through a tree that has more than twenty directories. Operation of the Up/Down Arrow keys may seem a bit confusing at first, but most users will eventually appreciate the flexibility inherent in this design. In the default cursor movement mode, these keys move the cursor up and down one directory at a time, regardless of level. The Tab key is used to toggle the movement mode. Thus the Up/Down arrow keys can be set to move up and down one directory at a time regardless of level or can be set to move up and down at the same level only. Regardless of the current setting, the Right Arrow key will always move the cursor down to the next directory regardless of level and the Left Arrow key will always move the cursor up in the same manner. As the cursor bar is moved, TM performs several ancillary functions. One of these functions is to display a subset of the files (10 files at a time) found in the directory currently highlighted by the cursor bar. Up to 10 files (first 10 found by DOS) can be displayed in the file list window, which is located in the bottom right portion of the main TM display. A major function of the cursor bar is to facilitate changing the active directory. All the user need do is position the cursor over the desired directory and press the ENTER key. When this occurs, TM will change to the target directory and terminate, leaving the user in the new directory. MOUSE SUPPORT TM will automatically detect the presence of a system mouse drive and activate the mouse if one is present. The directory tree cursor bar can be moved by moving the mouse up and down or right and left. The mouse left button emulates the Enter Key, the right button emulates the Esc Key, and pressing both left and right buttons together calls help. The mouse is not active while in the directory memo editor. FUNCTION KEY COMMANDS The majority of functions provided by TM can be accessed via one of the ten function keys. F1 - On-line Help - 7 - F2 - Directory Data Display F3 - Change Drive F4 - Remove Subtree F5 - Search for File F6 - Rename Directory F7 - Edit Directory Memo F8 - Toggle File List ON/OFF F9 - Browse Files in Directory F10 - Configure TM Each of these functions will be explained in greater detail in the following subsections. F-1 KEY The F-1 Key is used to access the on-line context sensitive help system incorporated into TM. When pressed while the tree cursor is active, the main help index will be displayed. If pressed while in any other TM function, help for the active function is displayed. The Alt-F1 key can be used to return to the last help topic displayed while in the help system. Mouse users may press the LEFT and RIGHT mouse buttons to invoke the help function. F-2 KEY The F-2 key activates a window that contains much interesting information about the contents of the directory currently under the cursor bar. This drive information display will show the total number of files, number of files with hidden/read-only/system attributes, the largest and smallest files, the oldest and newest files, and other information. F-3 KEY The F-3 key is used to change drives. Any valid drive in the system may be accessed by simply pressing the letter key that corresponds to the DOS drive letter. If the selected drive is not valid or the drive is not ready, an error message will appear in an error window. F-4 KEY TM has the capability to remove a complete subtree structure. When the F4 Key is pressed, TM will display a window that will issue TWO confirmation prompts before proceeding to remove ALL subdirectories and ALL files therein from the subtree attached to the directory under the cursor bar when F4 was pressed. Use this feature with CAUTION. It - 8 - will remove ALL files in each subdirectory to be removed, including those marked as read-only, system, or hidden. F-5 KEY TM provides a very rapid file search of the entire active drive for a specified file name. To search for a file, press the F-5 key and then enter the file name as prompted for in the file search window that will appear. DOS wild cards ("*" and "?") are permitted. TM will gather all files found on the current drive that match the entered file specification and present the list in the file browse mode. Using the global mask "*.*" permits browsing all files on the current drive. See the File Browse Mode section for further details. F-6 KEY TM makes it very easy to rename a directory. Pressing the F-6 key will activate a window that will prompt for the new name of the directory under the cursor bar. Any legal DOS directory name may be entered. This includes names that contain a period, as in LONGNAME.DAT. If the entered name is the same as the name of a directory at the same level, an error window will appear, otherwise the directory will be renamed. The graphic tree is resorted after the renaming of a directory. F-7 KEY TM supports maintenance of a small ASCII text memo file for each directory. The memo file serves to provide the user with a means of keeping comments or other data pertinent to specific directories. To edit or create a memo file, press the F7 key. A window will appear that supports a full- featured text editor. Up to 12 lines, 40 characters each, may be entered into the text buffer. Standard WordStar style commands are employed while in the buffer. A status line at the top of the editor window shows column number, line number, Insert key status, and percent of buffer space used. Press F1 while in the editor for a list of basic editor commands. To save the memo, press F10 when entry of the desired information is complete. A file named DIRMEMO.TM will be created in the directory highlighted by the tree cursor when F7 was pressed. Press Esc to exit the editor without creating or updating the file. If a file named DIRMEMO.TM exists in the directory under the cursor bar when F7 is pressed, TM will read that file into the buffer for examination and editing. Note that the mouse is not active while the memo editor is active. - 9 - F-8 KEY TM will normally display the first 10 files found in each directory as the cursor bar is moved through the tree. This slows down the cursor movement a bit due to the requirement to access the disk, especially on slower drives. Pressing F-8 Key toggles this feature on and off. When toggled off, TM does not access the disk to get the first 10 files and the message "File List Disabled" appears at the top of the file list window. The file list will automatically turned on during a file search if the target file is found and the user elects to stop the search normally. F-9 KEY The F-9 key is used to browse all files in the directory under the tree cursor bar that match the current file mask. The file mask can be changed with the Ctrl-M command. See the File Browse Mode section for further details. F-10 KEY Pressing the F-10 key brings up a sliding bar menu that permits configuring TM. Pressing the Enter Key will alter the setting of the item under the cursor bar. If Quit and Save is selected, TM will save the configuration file TMCONFIG.BIN to the directory that TM.EXE resides in providing that this directory is on the DOS PATH. If it is not, TM will save TMCONFIG.BIN to the current directory. When TM loads and executes, it searches the DOS path for TMCONFIG.BIN and reads it if TMCONFIG.BIN is found on the DOS PATH. Therefore, a copy of TMCONFIG.BIN must reside in a directory that is on the PATH in order for the saved configuration to be active when TM starts. OTHER TM COMMANDS TM provides other important functions through command keys as described below. INS KEY The Ins key is used to invoke the add directory function that adds a directory to the current drive. A window will appear that prompts for the name of the directory to be created. It is important to note the position of the tree cursor bar when invoking this function. If it is desired to add the directory to the root directory, type a DOS backslash character ("\") as the first character in the name. For example, to add a directory named ARCM directly to the root - 10 - directory, type in \ARCM and press enter. If however, it is desired to append a subdirectory to the directory highlighted by the cursor bar, do NOT precede the entry of the name with the backslash character. If the entered name is valid and if another directory of the same name at the same level does not exist, the directory will be created and added to the tree. Note that the tree is resorted following the addition of a directory. DEL KEY Directories may be removed in TM by pressing the Del key with the cursor bar over the target directory. The remove directory function will remove the directory from the drive and from the tree. Remember, the directory must not contain any files or subdirectories or an error will occur. The target directory will be removed from the drive and from the tree if the action is successful. CTRL-END KEY TM provides a fast, powerful method of cleaning up hard disks through the directory purge function. The entire contents of a directory may be purged by pressing the Ctrl-End key combination. Not to worry, the user must confirm TWICE before the action actually takes place and it is not possible to purge the root directory while in TM. A user might do a lot of damage through negligent use of this function, so BE CAREFUL! Press the Ctrl-End key combination with the tree cursor bar highlighting the target directory. A window will appear that will issue two separate prompts for user confirmation of the purging action. Please note that when TM cleans out a directory, it takes with it ALL files, regardless of attribute. This means that hidden, read-only, system files et al will be deleted. After the purging action, a message informing the user of success or failure will appear. Directories containing subdirectories may be purged without effecting the child subdirectories or their contents. CTRL-HOME KEY Normally, changing directories is effected by moving the cursor bar to the target directory and pressing return. But the root directory does not appear on the tree. To change to the root directory, press the Ctrl-Home key. - 11 - TAB KEY Pressing the Tab key toggles the functionality of the up/down arrow keys as pertains to the movement of the cursor bar from level to level. CTRL-M KEY As distributed, TM uses a file mask of "*.*" (all files) for retrieving file names from DOS for display in the file list window. This default can be changed through the use of the Ctrl-M command. A window will appear that prompts for entry of the new file mask. Any valid DOS file mask may be entered. After the mask is changed, only those files matching the file mask will be displayed in the file list window. Please note that the total file value that appears on the window header will still show the total number of "*.*" files in that directory. Also note that the current file mask setting will be saved to disk along with the other configurable items when the user elects to reconfigure TM. CTRL-P KEY A printout of the entire tree structure is available via the Ctrl-P Key. Please note that if the attached printer does not support IBM line drawing characters, the resultant printout will appear rather garbled. A warning will be issured if TM detects that the printer is not ready. This warning can be bypassed in those cases where the not ready indication is false. CTRL-R KEY The Ctrl-R Key is only active in the Shareware distribution version of TM. When pressed, Ctrl-R will cause a window to appear that prompts the user for Registration information. When the form is complete, the user has the option of printing the form for mailing to New-Ware. CTRL-S KEY In consonance with the design employed in ArcMaster and SCOUT, TM employs a directory catalog strategy. This strategy entails the storage of directory tree information in a small file named NEW-WARE.LOG in the root directory of each drive accessed. Using this strategy greatly speeds up operation of the program because it is not necessary to scan the entire disk through DOS each time a drive is accessed. The only drawbacks to this strategy are minor and are far outweighed by the increased performance. If a directory is created, - 12 - renamed, or removed other than by TM, ArcMaster, or SCOUT, it will be necessary to re-scan the drive to update the catalog. This is accomplished by pressing the Ctrl-S. Catalog maintenance by TM is mostly automatic and re-scanning should be a rare necessity. FILE BROWSE MODE The TM file browse mode is active when either the file search (F5 Key) or the directory browse (F9 key) functions are activated. Files are displayed in two columns of 21 files per column. All files matching the user-provided file specification will be listed and a movable cursor bar is available to browse through the file list. Up/Down arrow, PgUp/PgDn, Home/End, Ctrl-PgUp/Ctrl-PgDn keys are can be used to move through the list. Files can be sorted in any one of five ways and the sort may be changed at any time while in the browse mode. The Tab Key is used to toggle the direction of the sort to ascending or descending. The F1 key provides information on all the commands available while in the browse mode. Individual files may be LISTed, EDITed, SCANed, or executed from the browse mode. In addition, ArcMaster may be called and passed the file name under the cursor bar. TM provides a fast, easy method of finding a file name while in the browse mode. Pressing any key associated with a legal DOS file name character will cause TM to search the entire browse list for a file name beginning with that character. If it finds one, the cursor will jump to that file name and the first character typed will appear on line 23 of the display. TM will continue the search and build the search string with each character pressed. The backspace key may be used to delete characters from the string and the string will be cleared any time a cursor pad key (Down arrow, PgUp, Home, etc.) is pressed. This feature works best, of course, when the list is sorted by name in ascending order. Compressed ARC and ZIP file directories may be viewed while in the browse mode. To view the contents of an ARC or ZIP file, press ENTER with the cursor bar over the target file. TM can also call Buerg's LIST program to view compressed files. Pressing ENTER with the cursor over a file listed in an ARC or ZIP directory will cause TM to decompress the file and pass it to list. Note that either ARC.EXE, ARCE.COM, PAK.EXE, PKUNPAK.EXE, (for .ARC files) or PKUNZIP.EXE (for .ZIP files) must be in the DOS PATH for this feature to be operable. DIRECTORY NAME SEARCH Some users may have a large number of directories in a graphic tree for a particular drive. TM offers a quick method of moving the cursor to a desired directory name that might be several display pages down in the tree. If a character key is pressed, TM will automatically search through the tree and position the cursor on the directory name whose - 13 - first character matches the pressed key. If a second character key is immediately pressed, TM continues the search by searching for directory names that match the two characters. Subsequent character key presses add to the search string and the cursor bar is moved each time a new match is found. The currently active search string is displayed at the bottom of the tree. The backspace key can be used to delete characters from the string. If any key other than an alphabetical character or legal directory name character key is pressed, the search string is cleared. PROGRAM LIMITATIONS TM is designed to operate on IBM PC/XT/AT/PS2 and compatible computers. It requires approximately 120K of free RAM at runtime. Hercules, MDA, CGA, EGA, and VGA monitors are supported. TM supports up to 500 directories per drive. The total number of files that can be listed while in the browse mode is limited to 4000. Since a 20 megabyte disk partition will contain an average of approximately 1000 files, this limit should be adequate. A warning message will be displayed if the number of files TM can handle is exceeded. Please note that if a drive is searched using the global file specification of "*.*" and the number of files on the drive exceeds memory capacity, TM will terminate the find function before all files on the disk are placed on the list. Similarly, in the unlikely event that TM is used on a drive that contains more than 500 directories, not all available directories will appear on the tree. Both of these limitations are quite reasonable and should not hinder the majority of users from exploiting the power of TreeMaster. While TM will operate perfectly well on 5 1/4" and 3 1/2" floppy drives, it is designed for maximum efficiency on a hard drive. Turning off the file list display (F8) will speed up operations on a slow drive. The graphic tree printout functions sends IBM line drawing characters to the printer. Some printers do not directly support these characters and may substitute non-line characters thus reducing the quality of the resultant printout. The width of the window that contains the graphic tree display is great enough to support at least 5 levels of directories with each directory name eight characters in length. Directory tree levels greater than five with extended length names may overrun the right edge of the display. ERROR HANDLING TM incorporates extensive error handling. DOS critical errors such as "Drive not ready" and "Attempt to write to a write-protected disk" are trapped and displayed to the user. Any time TM cannot perform a - 14 - commanded function it will pop-up a window that informs the user of the nature of the error. Normal program operation then continues. If a fatal error occurs that prevents continuation of normal program operation, a special error window will appear that explains the nature of the error and then TM will be terminated. Please report fatal errors to New-Ware. CREDITS TM employs special code swapping software developed by Kim Kokkonen of TurboPower Software. This unit permits TM to swap most of its resident code to expanded memory (EMS) or to disk when shelling out to call external programs such as LIST or QEDIT. If sufficient EMS memory is available for the swap, the swap will be almost instantaneous. If no EMS is available, the swap will be made to a temporary disk file named TMSWAP.$$$. In this case there will be a noticeable delay during the swap, especially if operating on a slow hard disk. It is recommended that swapping be kept OFF unless adequate EMS memory (350K+) is available for swapping or a very fast hard disk system is in use. New-Ware strongly recommends Sammy Mitchell's (Sem-Ware) outstanding text editor QEDIT. TM supports calling QEDIT to edit files on the browse list if a copy of QEDIT is named QEDIT.EXE and QEDIT.EXE resides in a directory that is identified in the DOS PATH. TM supports LISTing files with Vernon Buerg's famous LIST program. LIST must be named LIST.COM and reside on the DOS PATH. TM supports scanning full directories or selected files using John McAfee's VirusSCAN program. SCAN must be named SCAN.EXE and exist on the DOS PATH. TM supports compressing or decompressing selected files using PKWare's PKZIP and PKUNZIP. These files must be named PKZIP.EXE and PKUNZIP.EXE and reside on the DOS PATH. TM supports invocation of Pete Petrakis' free utility, LZESHELL version 3.0. LZESHELL is the ideal companion for LZEXE, which is a marvelous utility that compresses .EXE and converted .COM files and allows them to be executed in compressed form. Be sure to read LZESHELL.DOC for further information. TM also supports calling New-Ware's ArcMaster and passing it a specified file name. ArcMaster must be named AM.EXE and reside on the DOS PATH. Portions of this software are taken from Turbo Pascal Express, Revised by Robert Jourdain and are copyright 1987 by Robert Jourdain. - 15 - QEDIT, LIST, PKZIP, and SCAN are all Shareware products. New-Ware urges that those who use these products register them with their respective authors. TurboPower Software provides outstanding support for Turbo Pascal programmers. New-Ware strongly recommends TurboPower products to all Pascal users. Copyright 1990, All Rights Reserved New-Ware 8050 Camino Kiosco San Diego, CA 92122-1820 (619) 455-6225 - 16 - Index A F-1 Key 8 add directory 10 F-2 key 8 Alt-F1 key 8 F-5 key 9 Alt-R 4 F-6 key 9 Alt-X 6 F-8 Key 10 ASP 2 F-9 key 10 ASP Ombudsman 2 F4 Key 8 F7 key 9 B file list window 7 backspace key 14 file mask 12 file search 9 C function keys 7 change drive 8 color attributes 6 G Compuserve 3 Genie 3 Ctrl-End key 11 Ctrl-Home key 11 H Ctrl-M 12 Home key 7 Ctrl-P Key 12 Ctrl-R Key 12 I Ctrl-S 13 Ins key 10 Ctrl-T 6 cursor bar 7 L Left Arrow key 7 D left button 7 Del key 11 directory catalog 12 N directory purge 11 New-Ware 3 DISCLAIMER 2 DOS PATH 6 P drive information 8 PATHINFO.TXT 6 PgUp and PgDn 7 E PRODUCT LICENSE 2 End key 7 PROLOG 2 ENTER key 7 errors 14 Q Esc key 6 Quit and Save 10 F R F-3 8 re-scan 13 F-10 key 10 register 2 - 17 - REGISTRATION 3 Shareware version 3 registration fee 3 registration window 4 T remove directory 11 Tab Key 13 rename a directory 9 Tab key 7, 12 Right Arrow key 7 right button 7 U Up/Down Arrow 7 S Shareware 2 V Shareware Products BBS 3 VENDOR.DOC 4 - 18 -